<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>io_service::strand::dispatch</title>
<link rel="stylesheet" href="../../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="../../../index.html" title="Asio">
<link rel="up" href="../io_service__strand.html" title="io_service::strand">
<link rel="prev" href="../io_service__strand.html" title="io_service::strand">
<link rel="next" href="get_io_service.html" title="io_service::strand::get_io_service">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"><img alt="asio C++ library" width="250" height="60" src="../../../asio.png"></td></tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../io_service__strand.html"><img src="../../../prev.png" alt="Prev"></a><a accesskey="u" href="../io_service__strand.html"><img src="../../../up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../home.png" alt="Home"></a><a accesskey="n" href="get_io_service.html"><img src="../../../next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="asio.reference.io_service__strand.dispatch"></a><a class="link" href="dispatch.html" title="io_service::strand::dispatch">io_service::strand::dispatch</a>
</h4></div></div></div>
<p>
          <a class="indexterm" name="idp152311328"></a> 
Request the strand to invoke the given handler.
        </p>
<pre class="programlisting"><span class="keyword">template</span><span class="special">&lt;</span>
    <span class="keyword">typename</span> <a class="link" href="../CompletionHandler.html" title="Completion handler requirements">CompletionHandler</a><span class="special">&gt;</span>
<a class="link" href="../asynchronous_operations.html#asio.reference.asynchronous_operations.return_type_of_an_initiating_function"><span class="emphasis"><em>void-or-deduced</em></span></a> <span class="identifier">dispatch</span><span class="special">(</span>
    <span class="identifier">CompletionHandler</span> <span class="identifier">handler</span><span class="special">);</span>
</pre>
<p>
          This function is used to ask the strand to execute the given handler.
        </p>
<p>
          The strand object guarantees that handlers posted or dispatched through
          the strand will not be executed concurrently. The handler may be executed
          inside this function if the guarantee can be met. If this function is called
          from within a handler that was posted or dispatched through the same strand,
          then the new handler will be executed immediately.
        </p>
<p>
          The strand's guarantee is in addition to the guarantee provided by the
          underlying <a class="link" href="../io_service.html" title="io_service"><code class="computeroutput"><span class="identifier">io_service</span></code></a>.
          The <a class="link" href="../io_service.html" title="io_service"><code class="computeroutput"><span class="identifier">io_service</span></code></a>
          guarantees that the handler will only be called in a thread in which the
          io_service's run member function is currently being invoked.
        </p>
<h6>
<a name="asio.reference.io_service__strand.dispatch.h0"></a>
          <span><a name="asio.reference.io_service__strand.dispatch.parameters"></a></span><a class="link" href="dispatch.html#asio.reference.io_service__strand.dispatch.parameters">Parameters</a>
        </h6>
<div class="variablelist">
<p class="title"><b></b></p>
<dl>
<dt><span class="term">handler</span></dt>
<dd>
<p>
                The handler to be called. The strand will make a copy of the handler
                object as required. The function signature of the handler must be:
</p>
<pre class="programlisting"><span class="keyword">void</span> <span class="identifier">handler</span><span class="special">();</span>
</pre>
<p>
              </p>
</dd>
</dl>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright &#169; 2003-2015 Christopher M.
      Kohlhoff<p>
        Distributed under the Boost Software License, Version 1.0. (See accompanying
        file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
      </p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../io_service__strand.html"><img src="../../../prev.png" alt="Prev"></a><a accesskey="u" href="../io_service__strand.html"><img src="../../../up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../home.png" alt="Home"></a><a accesskey="n" href="get_io_service.html"><img src="../../../next.png" alt="Next"></a>
</div>
</body>
</html>
